<HTML><HEAD><TITLE>Manpage of XWIN</TITLE>
</HEAD><BODY>
<H1>XWIN</H1>
Section: File Formats (5)<BR>Updated: xorg-server 1.19.0<BR><A HREF="#index">Index</A>
<A HREF="../index.html">Return to Main Contents</A><HR>

<P>
<P>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>

XWinrc- XWin Server Resource Configuration File.
<P>
<P>
<A NAME="lbAC">&nbsp;</A>
<H2>DESCRIPTION</H2>

The X Server for the X Window System on the Cygwin/X environment
running on Microsoft Windows, <I>XWin</I> can be optionally configured
with the <I>XWinrc</I> file.  A system-wide configuration file should
be placed in <I>
/etc/X11/system.XWinrc</I>, a per-user file
should be put at <I>$HOME/.XWinrc</I>.  The <I>system.XWinrc</I> file is
read only if no <I>$HOME/.XWinrc</I> exist.
<P>

With the <I>.XWinrc</I> configuration file it is possible to do the
following:
<P>

1- To include items into the menu associated with the <I>XWin</I> icon
which is in the <I>Windows</I> system tray.  This feature functions in
all XWin modes that have such tray icon.
<P>

2- To include items into the menu which is associated with the
<I>Windows</I> window that <I>XWin -multiwindow</I> produces for each
top-level X-window.  That can be done both for the generic case and
for particular programs.
<P>

3- To change the icon that is associated to the <I>Windows</I> window
that <I>XWin -multiwindow</I> produces for each top-level X-window.
Again, that can be done both for the generic case and for particular
programs.  The new icons associated should be <I>Windows</I> format
icons <I>.ico</I>.
<P>

4- To change the style that is associated to the <I>Windows</I> window
that <I>-multiwindow</I> produces for  each  top-level  X window.   Again,
that can be done both for the generic case and for particular programs.
<P>
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>FILE FORMAT</H2>

<B>Keywords</B>

are case insensitive, but in this document they will be written
completely capitalized.
<P>

<B>Comments</B>

are legal pretty much anywhere you can have an end-of-line; they
begin with &quot;#&quot; or &quot;//&quot; and go to the end-of-line.
<P>

Quote marks in strings are optional unless the string has included spaces,
or could be parsed, ambiguously, as a misplaced keyword.
<P>

There are four kinds of instructions: miscellaneous, menu, icon and style.
<P>
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>Miscellaneous instruction</H2>

<DL COMPACT>
<DT><B>DPI </B><I>resolution</I>

<DD>
Sets the resolution for all screens, in dots per inch.  To be used when
the server cannot determine the screen size(s) from the hardware.
<P>
<DT><B>XKBLayout </B><I>layout</I>

<DD>
<DT><B>XKBModel </B><I>model</I>

<DD>
<DT><B>XKBOptions </B><I>option</I>

<DD>
<DT><B>XKBRules </B><I>rule</I>

<DD>
<DT><B>XKBVariant </B><I>variant</I>

<DD>
These options configure the xkeyboard extension to load a particular
keyboard map as the X server starts.  The behavior is similar to the
<I>setxkbmap</I>(1) program.
<P>
See the <I>xkeyboard-config</I>(7) manual page for a list of
keyboard configurations.
<P>
Alternatively, you can use <I>setxkbmap</I>(1) program after <I>XWin</I>
is running.
<P>
The default is to select a keyboard configuration matching your current
layout as reported by <I>Windows</I>, if known, or the default X server
configuration if no matching keyboard configuration was found.
<P>
<DT><B>DEBUG </B><I>String</I>

<DD>
The <I>String</I> is printed to the XWin log file.
<P>
<DT><B>TRAYICON </B><I>icon-specifier</I><B></B>

<DD>
The <B>TRAYICON</B> keyword changes the icon <I>XWin</I> displays in the
system tray area.
<P>
<DT><B>SILENTEXIT</B>

<DD>
The <B>SILENTEXIT</B> keyword, which takes no parameters, disables the
exit confirmation dialog if no clients are connected.
<P>
<DT><B>FORCEEXIT</B>

<DD>
The <B>FORCEEXIT</B> keyword, which takes no parameters, disables the
exit confirmation dialog always.  Unsaved client work may be lost but
this may be useful if you want no dialogs.
<P>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>Menu instructions</H2>

<DL COMPACT>
<DT><B>MENU </B><I>Menu_Name</I> {

<DD>
<BR>

<B></B><I>Menu_Item_Line</I>

<BR>

<B></B><I>Menu_Item_Line</I>

<BR>

<B></B><I>...</I>

<BR>

<B>}</B>

<BR>

This instruction defines a menu and asigns a <I>Menu_Name</I> to it.
<I>Menu_Item_Line</I> are lines  of any of the following types:
<DT><B>SEPARATOR</B>

<DD>
<DT><B></B><I>Item_Label</I>  EXEC <I>Command</I>

<DD>
<DT><B></B><I>Item_Label</I>  MENU <I>previously-defined-menu-name</I>

<DD>
<DT><B></B><I>Item_Label</I>  ALWAYSONTOP

<DD>
<DT><B></B><I>Item_Label</I>  RELOAD

<DD>
<BR>

The <I>Item_Label</I> is the string that is written in the menu item.
<BR>

<I>Command</I> is a string with the command that will be executed by /bin/sh.
Here paths should be <I>CYGWIN</I> style (e.g. /usr/local/bin/myprogram).
A string &quot;%display%&quot; appearing in the <I>Command</I> will be replaced
with the proper display variable (i.e. 127.0.0.1:&lt;display&gt;.0).
<BR>

<B>ALWAYSONTOP</B> sets the window to which the menu is associated to
display above all others.
<BR>

<B>RELOAD</B> causes the XWinrc file to be reloaded and icons and menus
regenerated.
<DT><B>ROOTMENU </B><I>previously-defined-menu-name</I>

<DD>
Includes the items in the indicated menu into the menu associated with
<I>XWin</I> that appears in the system tray.
<DT><B>DEFAULTSYSMENU </B><I>previously-defined-menu-name</I> ATSTART|ATEND

<DD>
Includes the items in the indicated menu into the menu associated with
generic top-level X-Windows in the <I>XWin</I> <I>multiwindow</I> mode.  The
keywords <B>ATSTART</B> and <B>ATEND</B> indicate if such items should be
included at the start or at the end of the menu.
<DT><B>SYSMENU {</B>

<DD>
<BR>&nbsp;&nbsp;<I>class-or-name-of-window</I>&nbsp;<I>defined-menu-name</I>&nbsp;<B>ATSTART|ATEND</B>
<BR>

<BR>&nbsp;&nbsp;<I>...</I>
<BR>

<BR>&nbsp;&nbsp;<B>}</B>
<BR>

Associates a specific menu to a specified window class or name
in <I>-multiwindow</I> mode. The keywords ATSTART or ATEND indicate if
such items should be included at the start or at the end of the menu.
<P>
<P>
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>Icon Instructions</H2>

When specifying an <I>icon-specifier</I> in the following commands several different formats are allowed:
<P>

<DL COMPACT>
<DT><I>NAME.ICO</I><DD>
filename of an .ico format file
<BR>

(e.g. &quot;cygwin.ico&quot;, &quot;apple.ico&quot;, &quot;C:\icons\cheese.ico&quot;, &quot;/usr/share/icons/moon.ico&quot;)
<DT><I>NAME.DLL,nnn</I><DD>
filename of a DLL with an index into it's ICON resources
<BR>

(e.g. &quot;c:\windows\system32\shell32.dll,4&quot;, the default folder icon,
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;/usr/bin/cygicons-0.dll,10&quot;,&nbsp;the&nbsp;hippo&nbsp;icon)
<DT><I>,nnn</I><DD>
index into the XWin executable's internal ICON resources
<BR>

(e.g. &quot;,101&quot; is the 1st icon in <I>XWin</I>)
<DT><B>ICONDIRECTORY </B><I>Windows-path-to-icon-directory</I>

<DD>
Defines the default directory for the file when an <I>icon-specifier</I> doesn't
contain an absolute path.
It should be a <I>Windows</I> style path (e.g. C:\cygwin\usr\local\icons).
<DT><B>DEFAULTICON </B><I>icon-specifier</I>

<DD>
Defines a replacement for the standard X icon for applications without
specified icons.
<DT><B>ICONS {</B>

<DD>
<BR>

<BR>&nbsp;<I>class-or-name-of-window</I>&nbsp;<I>icon-specifier</I>
<BR>

<BR>&nbsp;&nbsp;<I>...</I>
<BR>

<BR>&nbsp;&nbsp;<B>}</B>
<BR>

Defines icon replacements windows matching the specified window class or names.
If multiple name or class matches occur for a window, only the first one
will be used.
<P>
</DL>
<A NAME="lbAH">&nbsp;</A>
<H2>Style Instructions</H2>

<DL COMPACT>
<DT><B>STYLES {</B>

<DD>
<I>class-or-name-of-window</I> <I>style-keyword-1</I> <I>style-keyword-2</I> <I>style-keyword-3</I>
<BR>

<BR>&nbsp;&nbsp;<I>...</I>
<BR>

<B>}</B>
<P>
Associates specific styles to a specified window class or name
in <I>-multiwindow</I> mode.  If multiple class or name matches occur,
for a window, only the first one will be used.
<P>
The style keywords indicate the following:
<P>
<I>style-keyword-1</I>
<P>
<B>TOPMOST</B>
<BR>

Open the class or name above all NOTOPMOST Microsoft Windows
<BR>

<B>MAXIMIZE</B>
<BR>

Start the class or name fullscreen.
<BR>

<B>MINIMIZE</B>
<BR>

Start the class or name iconic.
<BR>

<B>BOTTOM</B>
<BR>

Open the class or name below all Windows windows.
<BR>

<P>
<I>style-keyword-2</I>
<P>
<B>NOTITLE</B>
<BR>

No Windows title bar, for the class or name.
<BR>

<B>OUTLINE</B>
<BR>

No Windows title bar and just a thin-line border, for the class or name.
<BR>

<B>NOFRAME</B>
<BR>

No Windows title bar or border, for the class or name.
<P>
<I>style-keyword-3</I>
<P>
<B>SKIPTASKBAR</B>
<BR>

Omit the class or name from being listed in the Windows taskbar.
<P>
Up to one keyword from each of these three groups can be used.  Not all
groups need be used, and the keywords can be given in any order.
<P>
<P>
</DL>
<A NAME="lbAI">&nbsp;</A>
<H2>EXAMPLE</H2>

<DL COMPACT>
<DT>This example adds an Xterm menu item to the system tray icon<DD>
<B>MENU systray {
<BR>

	 xterm  EXEC &quot;xterm -display %display% -sb -sl 999&quot;
<BR>

	 SEPARATOR
<BR>

}
<BR>

ROOTMENU systray
</B>
<P>
<DT>This example makes an oclock window frameless in <I>-multiwindow</I> mode<DD>
<B>STYLES {
<BR>

	 oclock NOFRAME
<BR>

}
<P>
<P>
<P>
</DL>
</B><A NAME="lbAJ">&nbsp;</A>
<H2>SEE ALSO</H2>

<BR>&nbsp;<A HREF="../man1/XWin.1.html">XWin</A>(1)
<P>
<P>
<A NAME="lbAK">&nbsp;</A>
<H2>AUTHOR</H2>

The XWinrc feature of XWin was written primarily by Earle F. Philhower
III.  Extended for style configuration by Colin Harrison.
<P>

<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
<DT><A HREF="#lbAD">FILE FORMAT</A><DD>
<DT><A HREF="#lbAE">Miscellaneous instruction</A><DD>
<DT><A HREF="#lbAF">Menu instructions</A><DD>
<DT><A HREF="#lbAG">Icon Instructions</A><DD>
<DT><A HREF="#lbAH">Style Instructions</A><DD>
<DT><A HREF="#lbAI">EXAMPLE</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
<DT><A HREF="#lbAK">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="http://savannah.nongnu.org/projects/man2html/">man2html</A>,
using the manual pages.<BR>
Time: 15:13:05 GMT, December 12, 2016
</BODY>
</HTML>
